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About This Guide 


This guide describes how to use the Novell® Client™ for Linux features available in the Novell 
Client tray application. This guide contains the following sections: 


+ Chapter 1, “Using the Novell Client Tray Application,” on page 9 
+ Chapter 2, “Using Novell Utilities,” on page 15 
e Appendix A, “Documentation Updates,” on page 23 

Audience 


This guide is intended for users of the Novell Client for Linux. 


Feedback 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comments feature at the bottom of each page of the 
online documentation, or go to www.novell.com/documentation/feedback.html and enter your 
comments there. 


Documentation Updates 


For the latest version of this documentation, see the Novell Client online documentation (http:// 
www.novell.com/documentation/linux_client/index.html). 


Additional Documentation 


For documentation on installing and administering Novell Client for Linux, see the Novell Client 1.1 
for Linux Installation and Administration Guide. 


For documentation on known issues, see the Novell Client for Linux Readme. 


For documentation on login scripts, see the Novell Login Scripts Guide. 


Documentation Conventions 


In this documentation, a greater-than symbol (>) is used to separate actions within a step and items 
within a cross-reference path. 


A trademark symbol @, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party 
trademark. 
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Using the Novell Client Tray 
Application 


The Novell® Client" for Linux workstation software extends the capabilities of Linux* desktops by 
providing access to NetWare® and Open Enterprise Server (OES). When installed on workstations, 
the Client lets you enjoy the full range of Novell services such as authentication via Novell’s 
eDirectory™, network browsing and service resolution, and secure and reliable file system access. 
The Client supports Novell’s traditional NCP™ protocol. 


Novell Client for Linux 1.1 supports workstations running Novell Linux Desktop (NLD) 9 SP3. 


For information on installing the Novell Client for Linux, see the Novell Client 1.1 for Linux 
Installation and Administration Guide. 


This section contains the following information: 


e Section 1.1, “Starting and Stopping the Novell Client Tray Application,” on page 9 
e Section 1.2, “Logging In to the Network,” on page 10 

e Section 1.3, “Logging Out of a Network Location (Server or Tree),” on page 11 

e Section 1.4, “Viewing Your Network Connections,” on page 11 

e Section 1.5, “Changing Your Network Password,” on page 12 

e Section 1.6, “Mapping Network Directories,” on page 12 


Section 1.7, “Disconnecting a Mapped Directory,” on page 13 
+ Section 1.8, “Changing the Location of the Novell Client Tray Application,” on page 13 
e Section 1.9, “Configuring the Novell Client,” on page 13 


Section 1.10, “Viewing Novell Client Version Information,” on page 14 


1.1 Starting and Stopping the Novell Client Tray 
Application 


You can use the Novell Client tray application to access many of the Novell Client for Linux 
features. Simply click the red N icon (à) located either in the tray or in the floating window. The 
location of this icon is based on your workstation and your preferences, and it can be changed using 
the Novell Client Options menu. See Section 1.8, “Changing the Location of the Novell Client Tray 
Application,” on page 13 for more information. 


Click È to see the following menu: 
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Figure 1-1 The Novell Client Tray Application Menu 


IN] Novell Login 

[N] Novell Logout 

Novell Connections 

À Change Password 

Œ Novell Map Directory 

S Disconnect Novell Mapped Directory 
Novell Utilities b 
User Preferences 
System Settings 
Novell Client for Linux Documentation 
About 


© ouit Ctri+Q 


If you want to stop the Novell Client tray application from appearing on the tray, click N> Quit. 


To restart the Novell Client tray application (or if for some reason the red N icon (à) does not 
appear in your tray or float window), use one of the following methods: 

e NLD GNOME: Click Programs > Accessories > Novell Tray. 

¢ NLD KDE: Click the menu button > Applications > Novell Tray. 

+ Enter the following command in a terminal window: 


/opt/novell/ncl/bin/ncl tray 


1.2 Logging In to the Network 


When you log in to the network, you gain access to directories and files as well as other services 
provided by network servers. Your network administrator should provide you with the required 
information so that you can log in. 


1 Use one of the following methods to open the Novell Login dialog box: 


+ Click > Novell Login. 
e NLD GNOME: Click Programs > Accessories > Novell Login. 
e NLD KDE: Click the menu button > Applications > Novell Login. 
2 Enter your username and password, then click Advanced. 
3 Specify the tree, context, and server information for the server you want to connect to. 


You can type a DNS name or an IP address for the server. See your network administrator for 
this information. 


If your network has SLP set up, you can browse a list of available trees, contexts, and servers 
by clicking their associated buttons. 


4 (Optional) To clear any existing connections to servers before logging in, select Clear current 
connections. 


5 (Optional) To run login scripts during this login session, click the Script tab, then select the 
options needed to run the login scripts. 
For more information on login scripts, see Section 1.2.1, “Running Novell Login Scripts during 
Login,” on page 11. 

6 Click OK to log in to the server specified in Step 3. 
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1.2.1 Running Novell Login Scripts during Login 


When you successfully log in to the network, one or more login scripts are executed. Login scripts 
can be used to automatically map drives and search drives to directories, display messages, set 
environment variables, and execute programs or menus. 


You can specify whether login scripts are run, whether the results are displayed, and whether the 
login window is automatically closed during login. In addition, if the login script uses the %2, %3, 
%4, or %5 variable, you can set these variables by clicking the Variables button. 


Your network administrator should provide information on whether to use login scripts and, if so, 
which login scripts to use. 


For additional information on setting up login scripts, see the Novell Login Scripts Guide. 


1.3 Logging Out of a Network Location (Server 
or Tree) 


You can log out of a network location in either of the following ways: 


e To log out of all existing connections, click A > Novell Logout > Logout. 


¢ If you are logged in to multiple trees and want to log out of a specific server or tree, click N> 
Novell Connections, select the tree or server that you want to log out of, then click Detach. 


1.4 Viewing Your Network Connections 


Novell Connections allows you to see what servers and trees you are logged in to. You can refresh 
connections, set a specific tree as your primary connection, or log out of a tree or server. 


1 Click Ù > Novell Connections. 


Novell Connections 


| ENCAJE vou are attached to the following: 


Available Connections: 


Resource User eDirectory Tree Conn No. Authentication State Trans Type 


NOVELL_INC * etobiasson.DOCDEV.PRV.Novell 


PRV-PROD81 § CN=ETOBIASSON  NOVELL_INC 21 eDirectory IP 
PRV-PROD93 § CN=ETOBIASSON  NOVELL_INC 9 eDirectory IP 


T ee #12 
í Close ) 


Set Primary | Refresh Detach 
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2 Do any of the following: 
e To set a connection as the primary connection: Select the server you want to set as the 
primary connection, then click Set As Primary. 


e To refresh a connection: Select the connection that you want to refresh, then click 
Refresh. 


e To disconnect from a connection: Select the connection you want to detach from, then 
click Detach. 


3 Click Close. 


1.5 Changing Your Network Password 


To change your eDirectory password: 
1 Click Ù > Change Password. 
2 Type your current password in the Old Password field. 
3 Type your new password in the New Password field. 
4 Retype the new password in the Confirm Password field. 
5 Click OK. 


1.6 Mapping Network Directories 


When you map a directory, you create a symbolic link or shortcut to a path on the network and 
assign it a name and location on your workstation. After the drive is mapped, you can use the 
symbolic link to access the network resource, if you have sufficient rights on that resource. You can 
map to a specific folder on the resource or to the root of the resource. 


1 Click > Novell Map Directory. 


Novell Map Directory 


Select the Novell directory you 
Novell want to map to and assign it a name 
and location on your workstation. 


Workstation File System 


Enter the location where the link will reside: 


Enter the name of the link or select a drive letter: 
+ 


r Novell File System 
Enter the server name and path to the directory 
you want to map to: 


2 Specify the path on the local file system where the symbolic link to the network resource is to 
be created (using forward slashes). 


For example: /home/bsmith 
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You can also click the Browse button and select the location on the local file system where the 
symbolic link is to be created. 


If no location is specified, the symbolic link is created in the Map Link Default Location 
configured in the System Settings or in your home directory. 


3 Type the name of the symbolic link to be created, or select a letter from the drop-down list (if 
you want to use a single letter as the name for the link). 


4 In the Novell File System field, type the server name and the path to the directory you want to 
map. 


The path can be in any of the following forms: 
e//server/volume/path 

e server/volume: 

e server/volume:/path 


+ directory object name.fully distiguished_ eDirectory_ path (such as a cluster volume, for 
example: my_dir.usrs.accnt.mycompany) 


You can also click the Browse button and locate the directory you want to map. 
5 Click Map. 


The mapped drive appears in your home directory (by default) or in the directory you specified in 
Step 2. 


1.7 Disconnecting a Mapped Directory 


1 Click Ù > Disconnect Novell Mapped Directory. 


2 Select the mapped directory that you want to disconnect from, then click Disconnect. 


1.8 Changing the Location of the Novell Client 
Tray Application 

Use the User Preferences dialog box to change the location of the Novell Client tray application. 
This is useful if your workstation has problems with tray icon support. If you are unable to see the 


tray icon under the Windows Manager, you can select the Use Float Window option to create a 
floating icon ( N ) that can be used to access the Novell Client tray application features. 


1 Click 2 > User Preferences. 
2 Select the location you want for the Novell Client tray application. 
3 Click OK. 


1.9 Configuring the Novell Client 
To configure the Novell Client, run the Novell Client Configuration Wizard. It lets you configure 
file browser, protocol, login, tray application, and OpenSLP settings. 

1 Click # > System Settings. 

2 If you are not logged in as root, type the root password, then click OK. 

3 Select the Client settings you want to configure, then click Start Wizard. 


4 Follow the instructions in the left panel to configure the Novell Client settings. 


Using the Novell Client Tray Application 


13 


5 When you are finished, click Finish. 
6 (Conditional) If you made changes to the Protocol Settings page or the Service Location 


Protocol (OpenSLP) Settings page, reboot the machine for those changes to take effect. 


For more information, see “Using the Novell Client Configuration Wizard” in the Novell Client for 
Linux Installation and Administration Guide. 


1.10 Viewing Novell Client Version Information 


To obtain version information for the Novell Client in the Novell Client tray application, click 
About. This window also contains information on the specific packages loaded, including their 
status, version, and release information. 


You can also link to the Novell Client for Linux product page (http://www.novell.com/products/ 
clients/linux/overview.html) from the About dialog box. 
1 Click È > About. 


2 Click the Packages tab to view information on the Novell Client for Linux packages loaded, 
including status, version, and release information. 


3 Click the Kernel tab to view information on the kernel and novfs. 
4 Click OK. 
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Using Novell Utilities 


You can access various Novell® utilities by selecting the Novell Utilities option on the Novell 
Client™ tray application menu. The options on the submenu let you do the following: 

e Section 2.1, “Assigning Rights to Volumes, Files, and Directories,” on page 15 

e Section 2.2, “Setting Inherited Rights and Filters,” on page 16 

e Section 2.3, “Viewing Object Properties,” on page 18 

e Section 2.4, “Salvaging Deleted Files,” on page 19 

e Section 2.5, “Purging Deleted Files,” on page 20 

e Section 2.6, “Sending Messages to Users,” on page 21 

e Section 2.7, “Sending Messages to the System Console,” on page 22 


2.1 Assigning Rights to Volumes, Files, and 
Directories 


The Trustee Rights utility lets you display and give rights to volumes, files, and directories on a 
Novell server. A trustee is an object (such as a User object, Group object, Organizational Role 
objects, or container object) that has (or will have) rights to a volume, directory, or file. Trustee 
assignments allow you to assign ownership, set permissions, and monitor user access. You must 
have the Access Control (http://www.novell.com/documentation/nw65/nss_enu/data/ 
bri5796.html#bs3fjo7) right to change trustee assignments. 


1 Click © > Novell Utilities > Trustee Rights. 
2 Select the folder or file you want to set trustee rights for, then click OK. 


Novell Services 


| Novell Rights 


Trustees SRWECMFA 


ETobiasson.DOCDEV.PRV.Novell madadi 


PHattangadi.ENG.BLR.INDIA. Novell EFFFPPRT 


Remove 


H + 
manne a +o» 


| Inherited Rights and filters... 


m Effective Rights 


íl Ok \ Cancel 
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3 To add a trustee, select the object in the tree diagram, click Add, then set the rights for this user 
by selecting the boxes under the letters on the right. 


For each trustee in the list, there is a set of eight check boxes, one for each right that can be 
assigned. If a check box is selected, the trustee has that right. To assign or unassign rights, use 
the check boxes in the dialog box. 


The following rights can be set for each trustee: 


e Read: For a directory, grants the right to open files in the directory and read the contents 
or run the programs. For a file, grants the right to open and read the file. 


Write: For a directory, grants the right to open and change the contents of files in the 
directory. For a file, grants the right to open and write to the file. 


Erase: Grants the right to delete the directory or file. 


Create: For a directory, grants the right to create new files and directories in the directory. 
For a file, grants the right to create a file and to salvage a file after it has been deleted. 


Modify: Grants the right to change the attributes or name of the directory or file, but does 
not grant the right to change its contents (changing the contents requires the Write right). 


File Scan: Grants the right to view directory and file names in the file system structure, 
including the directory structure from that file to the root directory. 


Access Control: Grants the right to add and remove trustees for directories and files and 
modify their trustee assignments and Inherited Rights Filters. 


Supervisor: Grants all rights to the directory or file and any subordinate items. The 
Supervisor right can’t be blocked by an Inherited Rights Filter. Users with this right can 
grant or deny other users rights to the directory or file. 


4 To remove a trustee, select one or more trustees in the Trustees list, then click Remove. 
5 To view a list of rights and filters inherited by this volume, click Inherited Rights and Filters. 


6 To apply the same trustee assignments to a group of selected files, click Combine Multiple 
Trustees. 


This check box is available only if you’re viewing the right for multiple files or directories. At 
least one of the files or directories must have at least one trustee assignment. The trustees and 
rights shown are the combined trustees and rights for all of the files. If you select Combine 
Multiple Trustees, the trustee assignments that are chosen apply to all of the selected files after 
you click OK or Apply. 


For example, Kim is a trustee of file _aand file b. Kim has Read, File Scan, and Access 
Control rights for file a and Read and File Scan rights for file b.Ifyouselect file a 
and file b and view their properties, Kim is shown as a trustee with Read, File Scan, and 
Access Control rights. 


If you select Combine Multiple Trustees and then click OK, Kim is given the Access Control 
right for file b. Therefore, Kim now has Read, File Scan, and Access Control rights for both 
file aand file b. 


7 Click Apply, then click OK when you are finished modifying trustee rights. 


2.2 Setting Inherited Rights and Filters 


The Inherited Rights and Filters utility lets you view and set information about trustees and rights. 
Rights assignments on eDirectory™ containers can be inheritable or non-inheritable, but all rights 
assignments on directories are inheritable. You can block such inheritance on individual subordinate 
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items so that the rights aren’t effective on those items, no matter who the trustee is. One exception is 
that the Supervisor right can’t be blocked. 


1 Click Ù > Novell Utilities > Inherited Rights and Filters. 

2 Select the folder or file you want to view or set inherited rights and filters for, then click OK. 
Inherited Rights and Filters 

A Te ZI Right-click a trustee to view effective rights and properties. 


Trustees Inherited from Selected Item and Parent Directories: SRWECMFA 


Scott_Group.DOCDEV.PRV.Novell - [DOC:] (m| m| m| m| 7 m 
ETobiasson.DOCDEV.PRV.Novell - [DOC:] Ld (72 (7A (AN 2d 
PHattangadi.ENG.BLR.INDIA.Novell - [DOC:edir873\} LFP 
ETobiasson.DOCDEV.PRV.Novell - [DOC:edir873\] MAAALA 


View Trustees Below Directory 


m Uncheck to filter rights inherited from parent directories 
# IX) Read # IX) Erase 2 R) Modify # R) Access Control 
# IX) Write BI IX) Create B R) File Scan B R) Supervisor 


Clear All 


Cancel | | 


The main part of this dialog box is the list of trustees inherited from the selected item and its 
parent folders. 


3 To assign or unassign rights, use the check boxes to the right of a trustee. 


For each trustee in the list, there is a set of eight check boxes, one for each right that can be 
inherited. If a check box is selected, the trustee has that right. 


The following rights can be set for each trustee: 
e Read: For a directory, grants the right to open files in the directory and read the contents 
or run the programs. For a file, grants the right to open and read the file. 


e Write: For a directory, grants the right to open and change the contents of files in the 
directory. For a file, grants the right to open and write to the file. 


e Erase: Grants the right to delete the directory or file. 


e Create: For a directory, grants the right to create new files and directories in the directory. 
For a file, grants the right to create a file and to salvage a file after it has been deleted. 


e Modify: Grants the right to change the attributes or name of the directory or file, but does 
not grant the right to change its contents (changing the contents requires the Write right). 


e File Scan: Grants the right to view directory and file names in the file system structure, 
including the directory structure from that file to the root directory. 


e Access Control: Grants the right to add and remove trustees for directories and files and 
modify their trustee assignments and Inherited Rights Filters. 


e Supervisor: Grants all rights to the directory or file and any subordinate items. The 
Supervisor right can’t be blocked by an Inherited Rights Filter. Users with this right can 
grant or deny other users rights to the directory or file. 


4 To see a list of trustees for subfolders of the currently selected folder, click View Trustees 
Below Directory. 
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A list of all the users and their rights to each subfolder appears. You can modify or remove 
rights from this list. 


5 To view a trustee’s current effective rights (taking into account the Inheritance filter), right- 
click a trustee name, then click Current Efjective Rights. 
Users can receive rights in a number of ways, such as explicit trustee assignments, inheritance, 
and security equivalence. Rights can also be limited by Inherited Rights Filters and changed or 
revoked by lower trustee assignments. The net result of all these actions (the rights a user can 
employ) are called effective rights. 


6 To view a trustee’s properties (such as if they have the rights to modify inherited rights at this 
level), right-click a trustee name, then click Properties. 


7 Click Apply, then click OK when you are finished modifying inherited rights and filters. 


2.3 Viewing Object Properties 


The Object Properties utility lets you view the property pages (Folder Information and Novell 
Rights) for a selected object. The property pages let you see information and statistics about that 
object. If you have sufficient rights, you can set attributes for that object. 


1 Click Ù > Novell Utilities > Object Properties. 
2 Select the object you want to see the properties for, then click OK. 


3 On the Folder Information page, you can view the owner of the folder, the name spaces 
enabled on the folder, the amount of disk space available to you, the date the folder was 
created, updated, and archived, and any attributes set on the folder. 


PUBLIC Properties 


Nove IL Information about selected directory 


Selected Directory: PUBLIC 


Owner: CN=etobiasson1.O=novell 
Name Space: LONG 


Space Restriction: 64.0 KB (64 KB) 
Space Available: 6.3 GB (6 644 696 KB) 


Created: 03 August 2005 11:44:38 
Update: 03 August 2005 11:44:38 
Archived: Never Archived 


Attributes: {| Read-only Archive 
C] Don't Compress Hidden 
[C] Immediate Compression Rename Inhibit 
[] Purge Immediate Delete Inhibit 


Cancel 


4 If you have rights to modify this object and need to make changes, select the properties you 
want to changed. 


5 To view the eDirectory rights associated with this object, click the Novell Rights tab. 
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PUBLIC Properties 


| Folder Information | Novell Rights 


Trustees SRWECMFA 
[Public] a 2 2 


D 


+-P eDirectory 


Inherited Rights and filters... 


r Effective Rights 
Read Erase Modify Access Control 
Write Create File Scan Supervisor 


íl Ok \ Cancel ‘| | 


If you have Access Control rights and need to make changes to the Novell rights associated 
with this object, see “Managing File Security” in the Novell Client 1.1 for Linux Installation 
and Administration Guide for specific steps on setting Novell file rights. 


If you do not have Access Control rights, your effective rights to the file appear in the Effective 
Rights box. You cannot change these rights. 


6 Click Apply, then click OK when you are finished viewing or modifying the object’s properties. 


2.4 Salvaging Deleted Files 


The Salvage utility lets you recover deleted files and directories from Novell file systems. Files that 
have been purged cannot be recovered. 


IMPORTANT: You cannot salvage files or directories from an OES for Linux Reiser volume. 


1 Click © > Novell Utilities > Salvage Deleted Files. 


2 Select the folder where the files you want to recover are located, then click OK. 
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Salvage Novell Directory Files 


Novell. 


Directory: HOME:\Etobiasson\sharing 


Salvageable Files: Status: Found 0 items 


File name | Date Deleted Time Deleted | File Size | User Name Last Update Date | Last Update Time | Last Updater t 


+ 


[R] Do not show 0 size files. 


3 Select the files you want to recover. 


To display files with 0 bytes, deselect Do Not Show 0 Size Files (selected by default). This 
refreshes the display to show all deleted files, no matter the size. 


4 Click Salvage File. 
To salvage all deleted files in the folder, click Salvage All. 
5 Click Close. 


2.5 Purging Deleted Files 


The Purge utility lets you purge deleted files and directories from Novell file systems. Deleted files 
are purged from a volume when one of the following events occurs: 


The Purge Delay setting times out. Deleted files are purged automatically. 


The server starts purging files if a volume starts to fill up; the oldest files that have been deleted 
are automatically purged. 


+ If you do not want a file to be restored after deletion, you can enable the Immediate Purge of 
Deleted Files parameter. The file is deleted and purged immediately. 


e You manually purge the deleted files. 


WARNING: The Purge utility permanently removes deleted files from the selected directory. 
Purged files cannot be recovered with the Salvage utility. 


IMPORTANT: You cannot purge deleted files or directories from an OES for Linux Reiser 
volume. 


1 Click © > Novell Utilities > Purge Deleted Files. 
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2 Select the folder where the files you want to purge are located, then click OK. 


Purge Novell Directory Files 


Novell. 


Directory: HOME:\Etobiasson\sharing 


Purgeable Files: Status: Found 0 items 


File name Date Deleted Time Deleted File Size | User Name Last Update Date | Last Update Time | Last Updater t 


| 


IR] Do not show 0 size files. 


( ) Purge Subdirectories 


3 Select the files you want to purge 


To display files with 0 bytes, deselect Do Not Show 0 Size Files (selected by default). This 
refreshes the display to show all deleted files, no matter the size. 


4 Click Purge File. 
To purge all deleted files in the folder, click Purge All. To purge subdirectories, click Purge 
Subdirectories. 

5 Click Close. 


2.6 Sending Messages to Users 


Use the Send Message to User utility to send a simple message to users on the network. You can 
send the message to a single user or group or to multiple users or multiple groups of users. The 
message appears on the receiver’s screen in a Message Popup dialog box. On your screen, the Send 
Message Results dialog box shows the results. Only users who are logged in at the time you send the 
message receive the message. 


IMPORTANT: This feature is not fully functional. You can send messages from a Linux 
workstation, but they can only be received by Windows* workstations. 


1 Click Ù > Novell Utilities > Send Message to User. 


2 Select a server to see a list of users and groups on that server, then click Select. 
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Send Message to Users or Groups 


Send message to the selected 
N ove | l. users or groups. 
ETOBIASSON1/CN=ADMIN 


Enter message text: 


Select the users or groups who should receive this message: 


User Name Conn No. 
& admin.novell 

& admin.novell 

&* admin.novell 

& etobiasson1 .novell 

& etobiasson1 .novell 

& etobiasson1 .novell 
3 


etobiasson1.novell 


IC) Show only user objects in list 


("send IO 


3 Type the message you want to send in the Enter Message Text field. 
4 Select the users or groups that you want to receive the message. 
5 Click Send. 
The Send Message Results dialog box shows which users or groups the message was sent to. 
6 Click OK, then click Close. 


2.7 Sending Messages to the System Console 


Use the Send Message to System Console utility to send messages to a server system console. 


IMPORTANT: This feature is not fully functional in this release. 


1 Click Ù > Novell Utilities > Send Message to System Console. 


2 Select a server, then click Select. 


Send Message to System Console 


Novell Send message to the server 


system console. 


ETOBIASSON1/CN=ADMIN 


Enter message text: 


3 Type the message you want to send in the Enter Message Text field. 
4 Click Send, then click OK. 
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Documentation Updates 


This section contains information on documentation content changes made in this guide since the 
initial release of the Novell® Client" for Linux. The information will help you keep current on 
updates to the documentation. 


The documentation was updated on the following dates: 


¢ Section A.1, “December 23, 2005,” on page 23 


A.1 December 23, 2005 


e Page design reformatted to comply with revised Novell documentation standards. 


Documentation Updates 23 


24 Novell Client 1.1 for Linux User Guide 


